MuleSoft Accelerator for SAP icon

MuleSoft Accelerator for SAP

1.5.x
(5 reviews)

Anypoint Partner Manager EDI setup guide

The following setup guide provides instructions to configure Anypoint Partner Manager (APM) to enable a trading partner to exchange EDI messages. SAP S/4HANA is used as the backend ERP system for creating and managing purchase orders, invoices, shipping notices, and invoice payments.

Configure storage

Configure your storage solution as described here to store transmission content.

Configure host

Configure the host organization as described here. For this use case, setup the following identifiers:

  • Reference ID
  • X12 - GS
  • X12 - ISA with ZZ

    Image of Host Identifiers

Create message types

Creating inbound message types for Purchase Order EDI 850 and Remittance Notice EDI 820

  1. Click New message type and select 'Receive from partner' from the Usage dropdown.
  2. Select 'Format X12' to receive X12 EDI messages and version as '4010'.
  3. Select Message type as 850 or 820.
  4. For Schema, select the 'Use standard' option.

    Inbound Message Types

Creating outbound message types for PO ACK 855, Shipping Notice 856, and Invoice Notice 810

  1. Click New message type and select 'Send to partner' from the Usage dropdown.
  2. Select 'Format X12' to receive X12 EDI Messages and version as '4010'.
  3. Select Message Type as 855, 856, or 810.
  4. For Schema, select the 'Use standard' option.

    Outbound Message Types

Creating Source message types to receive outbound message requests from the host's ERP System

  1. Click New message type and select 'Source at the host' from the Usage dropdown.
  2. Select 'Format JSON' to receive outbound message requests in JSON from the SAP Event Listener API.
  3. Upload JSON Schema for PO ACK, Invoice, and Shipping Notice matching the request schema.
  4. Upload the Reference dwl for reading identifiers and business mapping keys.

    Source Message Types

Creating target message types for PO and Remittance Info

  1. Click New message type and select 'Target at host' from the Usage dropdown.
  2. Select 'Format JSON' to receive inbound messages in JSON from Inbound Message flows.
  3. Upload the JSON Schema for Order CIM and Payments CIM format.

    Target Message Types

Create host endpoints

Configuring endpoints for inbound messages

  1. Click New and select 'Target at host' to configure endpoints for the Orders System API and the Invoice Payments System API.
  2. Use 'HTTPS' as the protocol and configure the host endpoint in the URL.
  3. Select the 'Authentication type' based on host API requirements and appropriate certicate.

    Target Endpoints

Configuring APM endpoints for outbound messages

  1. Click New and select 'Source at host' in the Usage field to receive messages from the SAP S/4HANA Event Listener.
  2. Use 'HTTPS' in the Protocol field and configure the URL, Base Path, and Authentication type as shown in the following:

    Host Endpoints

Configure partner

Configure the trading partner as described here. For this use case, set up the following identifiers:

  • Reference ID
  • X12 - GS
  • X12 - ISA with ZZ

Partner Identifiers

Create partner endpoints

To receive and send EDI messages, set up endpoints based on the mode of exchanging messages such as FTP, AS2, or HTTPS.

Configuring receive endpoints

  1. Click New and select 'Receive from partners' from the Usage dropdown.
  2. Select 'SFTP' in the Protocol dropdown to receive files from a partner's SFTP host.
  3. Add the SFTP host and authentication information.
  4. Create multiple endpoints for picking up different EDI message types.

    Partner SFTP Receive

Configuring send endpoints

  1. Click New and select 'Send to partners' from the Usage dropdown.
  2. Select 'SFTP' in the Protocol dropdown to send files to a partner's SFTP host.
  3. Add the SFTP host and authentication information.

    Partner SFTP Send

Create APM message flows

Create message flows for each EDI message type with source and target endpoints, message types, and mapping scripts to convert to and from X12 EDI Message formats.

Receiving PO 850 from NTO Retail Partner

  1. Select New message flow -> Receive from partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to receive PO from.
  3. Under the Receive section, select the endpoint you created earlier to receive EDI 850 message from SFTP Host.
  4. Select Message type as X12-4010-850.
  5. Under the Map Section, upload the po-nto-x12-4010-850-to-order.dwl file.
  6. Select the Target message type as 'JSON-orderscim' and Endpoint as Orders System API.

    PO 850 Message Flow

Sending PO ACK 855 to NTO Retail

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to send POC Ack.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message type as JSON-poack.
  5. Select Reference IDs to route messages to this flow.
  6. Under the Map Section, upload the poack-sap-to-nto-x12-4010-855.dwl file.
  7. Select the Target message type as 'X12-4010-855' and Endpoint as 'SFTP-ntoretail-inbound'.

    PO 855 Message Flow

Sending Shipping Notice 856 to NTO Retail

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to send Shipping Notice.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message Type as JSON-poack.
  5. Under the Map Section, upload the shipping-sap-to-nto-x12-4010-856.dwl file.
  6. Select Target message type as 'X12-4010-856' and Endpoint as 'SFTP-ntoretail-inbound'.

    PO 856 Message Flow

Sending Invoice 810 to NTO Retail

  1. Select New message flow -> Send to partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to send Invoice.
  3. Under the Receive section, select the 'APM Send EDI Host' endpoint.
  4. Select Message Type as JSON-pack.
  5. Under the Map Section, upload the invoice-sap-to-nto-x12-4010-820.dwl file.
  6. Select Target message type as 'X12-4010-856' and Endpoint as 'SFTP-ntoretail-inbound'.

    PO 810 Message Flow

Receiving Remittance / Payment Info 820 from NTO Retail Partner

  1. Select New message flow -> Receive from partner on the 'Message flows' page in APM.
  2. Select NTO Retail or the partner to receive Payment Info from.
  3. Under the Receive section, select the endpoint you created earlier to receive EDI 820 message from SFTP Host.
  4. Select Message Type as X12-4010-820.
  5. Under the Map Section, upload the po-nto-x12-4010-820-to-payment.dwl file.
  6. Select Target message type as 'JSON-paymentscim' and Endpoint as Invoice Payments System API.

    PO 820 Message Flow

After you complete the message flows configuration, deploy the message flows.

You can also visit the troubleshooting steps if your Partner Manager is not working as expected.

Reviews